package com.yupi.yupicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.yupi.yupicturebackend.model.dto.user.UserQueryRequest;
import com.yupi.yupicturebackend.model.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.yupicturebackend.model.vo.userVo.UserLoginVo;
import com.yupi.yupicturebackend.model.vo.userVo.UserVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
* @author Administrator
* @description 针对表【user(用户)】的数据库操作Service
* @createDate 2025-07-03 11:07:33
*/
public interface UserService extends IService<User> {
    /**
     * 用户注册功能
     * @param userAccount 用户账号
     * @param userPassword 用户密码
     * @param checkPassword 确认密码
     * @return 新用户ID
     */
    long userRegister(String userAccount, String userPassword, String checkPassword);

    /**
     * 用户登录功能
     * @param userAccount 用户账号
     * @param userPassword 用户密码
     * @param request HTTP请求对象
     * @return 登录用户信息封装对象UserLoginVo
     */
    UserLoginVo userLogin(String userAccount, String userPassword, HttpServletRequest request);

    /**
     * 获取安全的用户信息（脱敏处理）
     * @param originUser 原始用户信息
     * @return 安全处理后的用户信息封装对象UserLoginVo
     */
    UserLoginVo getSafetyUser(User originUser);

    /**
     * 获取当前登录用户信息
     * @param request HTTP请求对象
     * @return 用户实体对象
     */
    User getLoginInfo(HttpServletRequest request);

    /**
     * 用户登出功能
     * @param request HTTP请求对象
     * @return boolean 是否成功登出
     */
    boolean UserLogout (HttpServletRequest request);

    /**
     * 将用户实体转换为用户展示对象
     * @param user 用户实体对象
     * @return 用户展示对象UserVO
     */
    UserVO getUserVO(User user);

    /**
     * 批量将用户实体列表转换为用户展示对象列表
     * @param userList 用户实体列表
     * @return 用户展示对象列表
     */
    List<UserVO> getUserVoList(List<User> userList);

    /**
     * 构建用户查询条件
     * @param userQueryRequest 用户查询请求参数
     * @return 查询条件构造器QueryWrapper
     */
    QueryWrapper<User> getQueryWrapper(UserQueryRequest userQueryRequest);

    /**
     * 对用户密码进行加密处理
     * @param userPassword 明文密码
     * @return 加密后的密码字符串
     */
    String getEncryptPassword(String userPassword);

    /**
     * 判断当前是否为管理员
     * @param user 当前用户
     * @return boolean 是否为管理员
     */
    boolean isAdmin(User user);
}
